home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C / Games / Xconq 7.1.0 / src / xconq-7.1.0 / doc / curses-sect.texi < prev    next >
Encoding:
Text File  |  1996-07-07  |  7.5 KB  |  202 lines  |  [TEXT/R*ch]
  1. @node Introduction to curses Xconq, Playing curses Xconq, Playing Xconq, Playing Xconq
  2.  
  3. @section Introduction to curses Xconq
  4.  
  5. @i{cconq} is a version of @i{Xconq}
  6. that requires only an ASCII terminal
  7. and a @i{curses} library for cursor movement and screen management.
  8. As a result, it will run almost anywhere.
  9.  
  10. @c including DOS - should try to build it under go32 or some such
  11.  
  12. However, in exchange for this higher degree of portability,
  13. you lose a lot in display power, and games may become much more
  14. difficult to play.  For instance, roads and rivers cannot be
  15. represented directly, and you will have to rely on the textual
  16. displays to see which directions have them.
  17.  
  18. (Incidentally, this curses interface is the oldest one in Xconq,
  19. predating even the X10 interface that was part of version 1's
  20. release in 1987.)
  21.  
  22. @menu
  23. * Installing curses Xconq::
  24. * Playing the Introductory Game with curses Xconq::  
  25. @end menu
  26.  
  27. @node Installing curses Xconq, Playing the Introductory Game with curses Xconq, Introduction to curses Xconq, Introduction to curses Xconq
  28.  
  29. @subsection Installing curses Xconq
  30.  
  31. The usual @samp{make} and @samp{make install} will generate and install
  32. the executable and library into @file{usr/games/bin} and
  33. @file{usr/games/lib/xconq}, respectively.  (See the file @file{INSTALL}
  34. in the main source directory for more detailed instructions.)
  35.  
  36. The name of the executable is @file{cconq}.
  37.  
  38. @node Playing the Introductory Game with curses Xconq, , Installing curses Xconq, Introduction to curses Xconq
  39.  
  40. @subsection Playing the Introductory Game with curses Xconq
  41.  
  42. To begin an introductory game, give the command @samp{cconq -g intro}.
  43.  
  44. @node Playing curses Xconq, Troubleshooting curses Xconq, Introduction to curses Xconq, Playing Xconq
  45.  
  46. @section Playing curses Xconq
  47.  
  48. @menu
  49. * curses Xconq Command Line Options::
  50. * curses Xconq Screen::
  51. * curses Xconq Commands::
  52. @end menu
  53.  
  54. @node curses Xconq Command Line Options, curses Xconq Screen, Playing curses Xconq, Playing curses Xconq
  55.  
  56. @subsection curses Xconq Command Line Options
  57.  
  58. The command options are as for X11 Xconq (see @xref{Xconq Command Options}),
  59. except that the X-specific options will not be recognized.
  60.  
  61. @node curses Xconq Screen, curses Xconq Commands, curses Xconq Command Line Options, Playing curses Xconq
  62.  
  63. @subsection curses Xconq Screen
  64.  
  65. When @file{cconq} starts up, it takes over the whole screen,
  66. in the usual fashion of curses programs.
  67.  
  68. The layout is generally similar to the appearance of the X11
  69. map window.  Some changes were dictated by the need to fit
  70. everything into the standard 24x80 terminal screen
  71. (@file{cconq} can use a bigger or smaller screen
  72. if necessary though).
  73.  
  74. @example
  75. Your town Drumheller will build 99 armor                     Turn   1
  76.  
  77. your town Drumheller  HP 20  ACP 0/1       |1*  83%/6   Brazilians (term)
  78. In desert(Elev 1825) road/NE at 12,12      |2  100%     Japanese ()
  79. Occ 1 a                                    |-Sides------------------------
  80. fuel 500/500  ammo 200/200                 | *1 Hooker             1w
  81.                                            | *1 Joe Batt's Arm     1w
  82.    ?   ?   ?   ? ++++....  ?   ?   ?   ?   | *1 East Missoula      1w
  83.                 ^#+#......                 |**1 Drumheller           
  84.  ?   ?   ?   ? ^#+#+#......  ?   ?   ?   ? | *1 Nirmal             1w
  85.               ^^^^*1@@1......               | @@1 Wonthaggi          1w
  86.    ?   ?   ?   ^^^^*1==....?   ?   ?   ?   |
  87.                 ^^^^+#*1....               |
  88.      ?   ?   ?   ^^^^*1+#*1..?   ?   ?   ? |
  89.                   ^#^^~~+#++..             |
  90.        ?   ?   ?   ^#~~~~++++  ?   ?   ?   |
  91.                                            |
  92.          ?   ?   ?   ?   ?   ?   ?   ?   ? |
  93.                                            |
  94.            ?   ?   ?   ?   ?   ?   ?   ?   |
  95.                                            |
  96.              ?   ?   ?   ?   ?   ?   ?   ? |
  97.                                            |
  98. --Map--Survey----(units)-------------------|-Units--ALL---by side---------
  99. @end example
  100.  
  101. The main display is the map, which is in the lower left.  It uses game-defined
  102. characters to represent units and terrain - in the above example, @code{'..'},
  103. @code{'++'}, etc represent sea, land, and so forth respectively.  Units appear
  104. as a character for the type (@code{'*'} is a town) followed by a decimal digit
  105. indicating the side.  Unknown terrain is a combination of blanks and question
  106. marks, while the presence of borders and connections is flagged by a @code{'#'}.
  107.  
  108. Above the map is a textual description of the currently selected unit and its
  109. current location.
  110.  
  111. At the top is a couple of lines for notices of events and feedback from commands.
  112.  
  113. The turn or date appears in the top right corner, while below it is a list of
  114. the sides, their numbers as appearing on the map, and their progress in the turn.
  115. Also, the side being displayed has the display @code{term}.
  116.  
  117. Below that is a list area, which you can use to display a list of actual units,
  118. or a summary of the numbers of each type that you have.
  119.  
  120. Interaction and display modes appear on the bottom line of each major subwindow.
  121. The map window indicates survey/move modes, as well as the kinds of optional
  122. data being displayed, while the list window indicates units/types, selectivity
  123. (all or only some units), and sorting of the list.
  124.  
  125. @node curses Xconq Commands,  , curses Xconq Screen,  Playing curses Xconq
  126.  
  127. @subsection curses Xconq Commands
  128.  
  129. The following are single-character commands specific to curses Xconq.
  130.  
  131. @table @code
  132.  
  133. @item @code{ _ }
  134. (@code{set-info-lines}) Set number of lines in info window.
  135. This command sets the number of lines used by the unit info
  136. window above the map.  The default is 4, which is insufficient
  137. to display the plan's tasks, or all of the supplies in games
  138. with many kinds of materials.  The prefix argument is the
  139. number of lines.
  140.  
  141. @item @code{ v }
  142. (@code{list-view}) Set list view.
  143.  
  144. @item @code{ > }
  145. (@code{grow}) Grow the map.
  146. This increases the amount of screen used by the map and decreases the
  147. amount used by the lists.
  148. The prefix argument is the number of columns to change; its default
  149. value is 5.
  150.  
  151. @item @code{ < }
  152. (@code{shrink}) Shrink the map.
  153. This decreases the amount of screen used by the map and increases the
  154. amount used by the lists.
  155. The prefix argument is the number of columns to change; its default
  156. value is 5.
  157.  
  158. @end table
  159.  
  160. The following are long-name commands; use @code{'o'} to enter them.
  161.  
  162. @table @code
  163.  
  164. @item @code{run}
  165. Run continuously for several turns.
  166. By default, you must manually end each turn.
  167. This command allows you to set the number of turns that will
  168. auto-finish.  Note that if the AI is controlling your side,
  169. and turns auto-finish, you will not be able to do any of sort
  170. of input, even to look around, unless the AI allows for it
  171. (by giving one or more units a @code{passive} plan).
  172.  
  173. @item @code{show}
  174. Show/hide elements of the map.
  175. The arguments to this command enable and disable various features of the
  176. map display.  You may prefix any of the arguments with @code{!} or @code{no}
  177. to achieve the opposite of the usual effect.
  178.  
  179. @code{terrain}, @code{t}
  180. Display or blank out the terrain.
  181.  
  182. @code{unit}, @code{u}
  183. Display or blank out the units.
  184.  
  185. @code{name}, @code{n}
  186. Display or blank out the names of features and units.
  187.  
  188. @code{people}, @code{p}
  189. Display or blank out people.
  190.  
  191. @code{one}, @code{1}, @code{two}, @code{2}
  192. Display the terrain character in one or two character positions of each
  193. displayed cell.
  194.  
  195. @end table
  196.  
  197. @node Troubleshooting curses Xconq, , Playing curses Xconq, Playing Xconq
  198.  
  199. @section Troubleshooting curses Xconq
  200.  
  201. Screen gets messed up on Sun4, for reasons I don't understand.
  202.